<?xml version="1.0" encoding="UTF-8"?>
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<meta name="copyright" content="© Copyright IBM Corporation 2009"/>
<meta name="DC.Rights.Owner" content="© Copyright IBM Corporation 2009"/>
<meta name="security" content="public"/>
<meta name="Robots" content="index,follow"/>
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="reference"/>
<meta name="DC.Title" content="The DITA Learning and training content specialization: Overview, processing, and sample content"/>
<meta name="abstract" content="This zip provides sample content and processing for use with the OASIS DITA 1.2 learning and training content specialization."/>
<meta name="description" content="This zip provides sample content and processing for use with the OASIS DITA 1.2 learning and training content specialization."/>
<meta name="DC.Format" content="XHTML"/>
<meta name="DC.Identifier" content="README"/>
<meta name="DC.Language" content="en-us"/>
<!-- Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css"/>
<title>The DITA Learning and training content specialization: Overview,
processing, and sample content</title>
</head>
<body id="README"><a name="README"><!-- --></a>
<h1 class="topictitle1">The DITA Learning and training content specialization: Overview,
processing, and sample content</h1>
<div><p>This zip provides sample content and processing for use
with the OASIS DITA 1.2 learning and training content specialization.</p>
<div class="section"><h2 class="sectiontitle">Purpose</h2><p>This zip includes sample source
content that provides overview and assumptions about the goals and
objectives of the DITA 1.2 learning and training content specialization.
It also provides a set of sample content about four learning objects
that describe the goals and purpose of the specialization.</p>
<p>You
can use these samples to test and evaluate of how the learning and
training content specialization works.</p>
</div>
<div class="section"><h2 class="sectiontitle">How to use this content with the DITA Open Toolkit</h2><div class="p">You
can use this content with the DITA Open Toolkit 1.5, September 2,
2008 or later builds.<ol><li>Download and install the DITA Open Toolkit 1.5.<ul><li>Download the DITA OT 1.5 build install zip from <a href="http://sourceforge.net/project/showfiles.php?group_id=132728&amp;package_id=179008&amp;release_id=629084" target="_blank">http://sourceforge.net/projects/dita-ot/</a><div class="note"><span class="notetitle">Note:</span> For
best results, download the full_easy_install_bin option.</div>
</li>
<li>Unzip the DITA OT install zip to your local drive, usually to <samp class="codeph">c:\</samp> root.</li>
</ul>
</li>
<li>Unzip dita12_learning_samples.zip into the DITA OT doc directory.<p>This
creates a learningsamples folder in the samples directory and a plugins
folder for org.oasis.learning, which provides specialized processing
for the learning content.</p>
</li>
<li>From the DITA OT root directory, run startcmd.bat to open a command
prompt.<div class="note"><span class="notetitle">Note:</span> Opening the command prompt with startcmd.bat sets up
the necessary classpath and other environment variables you need to
complete the next steps.</div>
</li>
<li>Run this command:<pre class="pre"><kbd class="userinput">ant -f integrator.xml</kbd></pre>
<p>This
calls the plugin integrator, which installs the plugin files and enables
the specialized processing for the learning content.</p>
</li>
<li>Then run a build using the default toolkit builds (using the supplied
ANT files, or the Java™ command line).<ul><li>Use this command line to build the sample learning overview, assumptions,
and learning objects topics:<pre class="pre"><kbd class="userinput">java -jar lib/dost.jar /i:samples/learningsamples/ditaref-learning-rlo_samples.ditamap /transtype:xhtml /outdir:samples/learningsamples/out</kbd></pre>
<p>Launch
doc/learningsc/out/index.html in your web browser to view the results.</p>
<div class="note"><span class="notetitle">Note:</span> The
zip provides pre-built HTML outputs in the samples/learningsamples/out
folder. Open samples/learningsamples/out/index.html or samples/learningsamples/out/ditaref-learning-rlo_samples.chm
to view the pre-built learning sample output.</div>
</li>
<li>Use the prompted ant demo build. After running the command <kbd class="userinput">ant
-f build_demo.xml</kbd> in the main toolkit directory, enter
the input file name <kbd class="userinput">samples/learningsamples/ditaref-learning-rlo_samples.ditamap</kbd> and
then set other options as appropriate.</li>
</ul>
</li>
</ol>
</div>
</div>
<div class="section"><h2 class="sectiontitle">Building SCORM Output</h2><p>This zip also provides
basic processing to support processing to a SCORM 2004 output that
follows the best practices for a basic SCORM template, as outlined
here -<a href="http://wiki.oasis-open.org/dita/LearningContent/map2manifest_templates" target="_blank">SCORM best practices templates</a>.</p>
<div class="p">To build
SCORM output:<ol><li>From the DITA OT root directory, run startcmd.bat to open a command
prompt.<div class="note"><span class="notetitle">Note:</span> Opening the command prompt with startcmd.bat sets up
the necessary classpath and other environment variables you need to
complete the next steps.</div>
</li>
<li>Then run a build using this command line:<pre class="pre"><kbd class="userinput">java -jar lib\dost.jar /i:samples/learningsamples/ditaref-learning-rlo_samples.ditamap /outdir:samples/learningsamples/out /transtype:scormtemp4b</kbd></pre>
</li>
<li>Look for results in demo\learningsc\out.</li>
</ol>
</div>
<p>To use this output with a SCORM-compliant LMS or other
run-time environment, you will need to rename imsmanifest_4b.xml to
imsmanifest.xml, and put it and the html, and other output files into
a SCORM zip package, with all the necessary supporting XSD files. </p>
<p>See <a href="http://wiki.oasis-open.org/dita/LearningContent/scorm_schema_files" target="_blank">SCORM Schema Files</a> for information about how
to obtain the XSD files you need</p>
</div>
<div class="section"><h2 class="sectiontitle">Learning stub topics and sample test content</h2><div class="p">The
learningsamples folder also includes the following stub topics, maps,
and sample test content:<ul><li>stub_learningobject.ditamap </li>
<li>stub_learningPlan.dita </li>
<li>stub_learningOverview.dita </li>
<li>stub_learningContent.dita </li>
<li>stub_learningAssess.dita </li>
<li>stub_learningSummary.dita </li>
<li>learningsample.ditamap </li>
<li>testlearningAssess.dita </li>
<li>testlearningContent.dita </li>
<li>testlearningOverview.dita </li>
<li>testlearningPlan.dita </li>
<li>testlearningSummary.dita </li>
</ul>
</div>
</div>
</div>
<div class="nested1" xml:lang="en-us" id="README2"><a name="README2"><!-- --></a><h2 class="topictitle2">Overview: The DITA Learning and training content specialization</h2>
<div><p>The DITA 1.2 learning and training content specialization
specifies a set of specialized DITA topics, a learning interactions
domain, a learning metadata domain, and a learning map domain to support
creating and delivering structured learning content with DITA. </p>
<div class="section"><h3 class="sectiontitle">Learning topic types</h3><p>A set of five specialized
topic types provide the basic content ingredients for creating structured,
modular learning content with DITA 1.2.</p>
<dl><dt class="dlterm">Learning Plan topic type</dt>
<dd>Describes learning needs and goals, instructional design models,
task analyses, learning taxonomies, and other information necessary
to the lesson planning process.</dd>
<dt class="dlterm">Learning Overview topic type</dt>
<dd>Identifies the learning objectives, includes other information
helpful to the learner, such prerequisites, duration, and intended
audience.</dd>
<dt class="dlterm">Learning Content topic type</dt>
<dd>Provides the learning content itself, and enables direct use of
content from DITA task, concept, and reference topics, as well as
additional content of any topic type that supports specific objectives
declared in the Learning Overview topic type.</dd>
<dt class="dlterm">Learning Summary topic type</dt>
<dd>Recaps and provides context for the learning objectives and provides
guidance to reinforce learning and long-term memory.</dd>
<dt class="dlterm">Learning Assessment topic type</dt>
<dd>Presents instruments that measure progress, encourage retrieval,
and stimulate reinforcement of the learning content, and can be presented
before the content as a pre-assessment or after the content as a post-assessment
checkpoint or test.</dd>
</dl>
</div>
<div class="section"><h3 class="sectiontitle">Learning map domain</h3><p>The learning map domain
defines a set of specialized topic references for structured learning
content as learning objects and groups in a DITA map.</p>
<dl><dt class="dlterm">learningGroup</dt>
<dd>A container to introduce and group learning objects into higher-level
organizations, such as course-level, module-level, or lesson-level.
A learningGroup can contain other learningGroup elements, allowing
you to organize learning content at course, module, or other higher-levels
of hierarchy.</dd>
<dt class="dlterm">learningObject</dt>
<dd>A container to introduce and group the topic references for a
learning object. </dd>
<dt class="dlterm">learningPlanRef</dt>
<dd>A topic reference to a learning plan topic.</dd>
<dt class="dlterm">learningOverviewRef</dt>
<dd>A topic reference to a learning overview topic, which introduces
the learning object.</dd>
<dt class="dlterm">learningPreAssessmentRef</dt>
<dd>A topic reference to a learning assessment topic that is used
as a pre-assessment.</dd>
<dt class="dlterm">learningContentRef</dt>
<dd>One or more topic references to a learning content topic, or a
topic, task, concept, reference or other specialized topic.</dd>
<dt class="dlterm">learningSummaryRef</dt>
<dd>A topic reference to a learning summary topic.</dd>
<dt class="dlterm">learningPostAssessmentRef</dt>
<dd>A topic reference to a learning assessment topic that is used
as a post-assessment.</dd>
</dl>
</div>
<div class="section"><h3 class="sectiontitle">Learning interactions domain</h3><p>The learning
interactions domain defines a set of basic learning interactions elements
as a DITA domain. This domain is made available in the learningAssessment
topic type.</p>
<ul><li>lcOpenQuestion</li>
<li>lcTrueFalse</li>
<li>lcSingleSelect</li>
<li>lcMultipleSelect</li>
<li>lcMatching</li>
<li>lcHotspot</li>
</ul>
</div>
<div class="section"><h3 class="sectiontitle">Learning metadata domain</h3><p>The learning metadata
domain defines a set of basic learning metadata elements as a DITA
domain.</p>
<ul><li>lcLom, makes the lom elements available in the learning topics</li>
<li>lcMapLom, makes the lom elements available to the learning map
domain</li>
<li>lomAggregationLevel </li>
<li>lomContext </li>
<li>lomCoverage </li>
<li>lomDifficulty </li>
<li>lomInstallationRemarks </li>
<li>lomIntendedUserRole </li>
<li>lomInteractivityLevel </li>
<li>lomInteractivityType </li>
<li>lomLearningResourceType </li>
<li>lomOtherPlatformRequirements </li>
<li>lomSemanticDensity </li>
<li>lomStructure </li>
<li>lomTechRequirement </li>
<li>lomTypicalAgeRange </li>
<li>lomTypicalLearningTime</li>
</ul>
</div>
</div>
</div>
</body>
</html>
